org.globalplatform
Interface HTTPAdministration

All Superinterfaces:

javacard.framework.Shareable

public interface HTTPAdministration
extends javacard.framework.Shareable

This interface handles an HTTP administration session triggering request.

The object implementing this interface shall belong to the JCRE to have access to any object. The HTTPAdministration service shall verify that the method parameters are within bounds and all objects passed in as parameters are accessible from the caller’s context.

Since:

export file version 1.3

Method Summary

void	requestHTTPAdministrationSession(byte[] triggeringParameters, short offset, short length) Request an administration session.

Method Detail

requestHTTPAdministrationSession

void requestHTTPAdministrationSession(byte[] triggeringParameters,
                                      short offset,
                                      short length)

Request an administration session.

The Security Domain of the calling application will handle the PSK TLS security of the communication.

The calling application will be notified of the request execution if it implements the interface HTTPReportListener

Parameters:

triggeringParameters - this buffer contains the administration session triggering parameters as defined in Amendment B.

offset - offset within triggeringParameters

length - length of parameters within triggeringParameters

Throws:

java.lang.SecurityException - if triggeringParameters is not accessible in the caller’s context.

java.lang.NullPointerException - if triggeringParameters is equal to null.

java.lang.ArrayIndexOutOfBoundsException - if offset or length would lead to access outside array bounds.

javacard.framework.ISOException - with the following reason codes:

• SW_WRONG_DATA if data within triggeringParameters are not correctly formatted.
• SW_CONDITIONS_NOT_SATISFIED if operation could not be processed (for example if no SCP 81 support is possible for the calling application).